'WSl 



mm 



wxmBMMxmSwdmSmi 




FR ACTAL EXPLORER 



1 



■ 



;v^: 



PiiiiBWWliwi*' 



ECLAT 

P.O. Box S707S6 
Miami, I- 1, 3J257-9975 



mm 



■PHONE (305) :23 3-4666' 



ECLAT MicroProducts™, MIAMI, FLORIDA 



FRACTAL EXPLORER computer program and its documBntation are 
copyrighted (1988) by ECLAT MICROPRODUCTS of Miami, Florida. You 
may not copy or otherwise reproduce the product or any part of it except as 
backup copies. The original and any backup copies are Intended for your 
personal use on a single computer. You may not distribute copies of this 
product without the express written permission of ECLAT 
MICROPRODUCTS. 

PICTURES GENERATED WITH FRACTAL EXPLORER MAY BE FREELY 
DISTRIBUTED. 

NO OTHER FILES OR OPERATING CODE; BASIC, OR ASSEMBLY LANGUAGE 
MAY BE DISTRIBUTED. ONLY THE PICTURES CREATED BY FRACTAL 
EXPLORER MAY BE DISTRIBUTED. 



APPLE COMPUTER, INC, MAKES NO WARRANTIES, EITHER EXPRESSED OR 
IMPLIED. REGARDING THE ENCLOSED COMPUTER SOFTWARE PACKAGE. 
ITS MERCHANTABILITY OR ITS FITNESS FOR ANY PARTICULAR 
PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED 
BY SOME STATES. THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. 
THIS WARRANTY PROVIDES YOU WITH SPECIFIC LEGAL RIGHTS. THERE 
MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE 
TO STATE. 

PRODOS e and PRODOS 16 are copyrighted programs of Apple Computer. 
Inc. licensed to ECLAT MICROPRODUCTS to distribute for use only in 
CG.Tbination with FRACTAL EXPLORER. Apple Software shall not be 
copied onto another diskette (except for archive purposes) or into memory 
unless as part of the execution of FRACTAL EXPLORER. When FRACTAL 
EXPLORER has completed execution Apple Software shall not be used by 
any other program. 



Apple is a registered trademark of Apple Computer. Inc. 

FRACTAL EXPLORER and ECLAT, are trademarks of ECLAT Mlcroproducts 

of Miami, Florida. 
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FRACTAU EXPLORER 



FRACTAL EXPLORER will allow you to create your own series of Fractal 
Images and to display them in a slide show with pre-programmed color 
effects. No programming knowledge is required. There are no numbers to 
enter. All Instructions needed are presented in menu form and prompts 
will guide you along the way. 

Apple lies generated Pictures are *C1 flletypes which are compatible with 
Paintworks<TH) and other Apple IIGS paint programs. 

FRACTAL EXPLORER Is also available In A 4 color Single Hires version 
for the Apple 11,11+, and a 16 color DoiAle Hires version for the Apple 
lIe,Uc and compatibles on one 5 1/4 in disk. 
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GETTINO STARTED 



Hake a Back-up copy of the FRACTAL EXPLORER master disk. Put the 
original away for safekeeping and use your back-up as your new master, 

FRACTAL EXPLORER comes with some Super Hires Fractal pictures 
already on the disk. These can be left on the disk or deleted, as the user 
desires. 

Sine* FRACTAL EXPLORER Is unprotected and Prodos compatible, use any 
Prodos disk copy program for making working copies, such as the System 
Utilities, it Is wise to make an additional back-up for making user disks 
and to put the original master away as an Archival copy. Do not distribute 
copies of the FRACTAL EXPLORER disk or ANY of the programs on the 
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THE SUDB SHOW 



ro view the sUde show of lh« pleturas already on the disk, simply Insert 
[he disk Into DRIVE 1 In your computer and turn on the power. 

the disk will boot and show you an Introductory page, ^ess any key (or 
limply wait a minute) and the main menu will appear. 

•elect RUN SLIDE SHOW from the menu. You will now see the Super 
■tires Pictures on the disk. YotJ c«n tiM rhit inilnwino cnmmAnnx during rhe 
illde show, 

C - Color Complement Picture 

X - Eicluaive or the Palette 

> - Cycle up the Palette 

i - Cycle down the Palette 

* - Select Next Palette 

- Select Previous Palette 
F - Color Fill Node On 

SPACE BAR - Pause (any key to re-startl 
-> RT ARROW - next picture In sequence 
<- LT ARROW - last picture In sequencs 
ESCAPE - Elit SUdeshow 



The user can set the slide show parameters by selecting menu Item, 
SLIDE SHOW OPTIONS. This wilt allow the user to set the time each slide 
Is displayed, pre-programmed Color Effects, and the number of times to 
repeat the slide show. Again, the user Is guided bv prompts and menu 
selections. 
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CREATING YOUR OWN FRACTALS 



By selecting CREATE FRACTAL PICS from the main menu, ustrs can 
create their own original fractal pictures. 

If the disk Is full. The user cannot create « new fractal Image w>tll some 
are deleted from the disk, 

HAKE USER DISK selection will delete all pictures encept picture number 
1, the first fractal Image (do not do this to your original disk inless you 
want to lose the pictures provided). 



200M NEW PICTURE selection will create a new picture from one of the 
pictures selected in the PICTURE AVAILABLE list. After selecting the 
Zoom option and a picture. Move the loom box around with the arrow keys, 
1,J,K,M keys or the mouse. When over the area of Interest, press the 
RETURN key to begin the drawing of the area In the KKJM BOX. The screen 
will slowly start to fill with the new Fractal picture. The image will take 
about 2-4 hours to fill. Since the number of calculations Increase with the 
number of times the picture is zoomed, pictures Zoomed 10 times may take 
10 to 20 hours to generate. So this will give your computer wjmething to 
do overnight. Partially completed pictures can be stored at any time, by 
pressing the ESC key and then following the menu Instructions - "Press S 
to Save Pic". The Picture can then be continued at a later time. This 
feature Is also useful for a picture that takes many hours to generate. 
Partially completed pictures can be saved and continued to Insjre ag .Inst 
their loss due to power outages or other calamities. 



While the picture If being 9«n«rated, the user c*n prcaa the following 
Color Effects keva 

C ' Complement screen Pixels 

X - Excl>MWe Or Ptlette V«lues 

¥ - Fin Hode On 

* - Select Next Palette Available 

- Select Ust Palette Avallabls 



The user can save the picture with the colors desired. Remember, the slide 
show can also be programmed to do these color effects plus palette 

cycling. 

When the create program has finished drawing the new fractal picture, a 
menu will appear that will allow the user to tS)ave the picture or (Qlult the 
CREATE program. The (Slave option will assign the next available picture 
number to the new picture and save It to disk. The SLIDE SHOW will 
automatically find all Pictures on the disk. If the user does not make a 
choice within a minute or so, the program will automatically save the 
completed picture to the disk, and add it to the slide i^ow directory. 
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CREATE JULIA SET FROM PICTURE allows the user to weate • plctire 
using the same mathematical expression as the Mandelbrot set, but the 
points are Initialized In a different manner. The constants for the Julia 
set are first chosen by the user from any Handelbrot Set Picture, by 
moving the " Julia Point " to a desired area. The resulting Julia set 
Picture will render a shape < or a set of shapes* which Is dependent on 
where the user set the Julia Point. Huch like the Zoom box, the user moves 
the Julia Point with the ARROW KEYS or I.J,K.M keys tor mouse) to the 
desired point and then presses the RETURN Key lor mouse button!. The 
screen will then begin filling In with a picture of the Julia Set for the 
chosen set of constants. 

Interestingly, Julia Set Pictures can be generated from Zoomed Mandelbrot 
Set Pictures. 

Trying to generate Julia Set Pictures from Jutla Set Pictures or Zoomed 
Mandelbrot Set pictures from Julia Set Pictures will give unpredictable 
results. 



VIEW A PICTURE allows the user to view the selected picture. Also the 
Color effects keys can be pressed during vlewkig. 



CONTINUE A PICTURE . as mentioned above, allows the user to continue • 
picture that was previously stored but not completed. The save and 
continue feature Is useful for pictures that cannot be completed In one 
session. 



DELETE A PICTURE allows a user to selectively delete any of tt»e l^ted 
pictures. If all of the pictures are deleted, see DRAW INITIAL PICTURE 
option. 



DRAW INITIAL PICTURE will create the exact same Picture as 
FRAC.P1CG51, which encompasses the entire Mandelbrot Set. This is 
useful If FRAC.PICGS1 Is erased from the disk. _^ ^ . , 

Some users may also want to erase all pics from the dl« and start trom 
"scratch", and see the first picture of a series being drawn. 
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WHAT IS FRACTAL CEOHETRY 



The type d{ geometry to which most pewle have been exposed la Euclidian 
Geometry, which uses X and Y co-ordinates to describe shapes such as 
circles or straight lines, but Is very poor In describing many tamlllar 
shapes, such as a tree or the shape of a cloud. 

Hany objects such as trees Indeed do have a shape to them. A fractal 
id^ape. A fractal shape Is a geometric shape that Is fragmented, from the 
latin word "fractus" as described by Benolt Mandelbrot In his book ■ The 
Fractal Geometry of Nature" ( see Acknowledgments). 

There are more than one type of fractals. There are 'Regular Fractals* 
and the "Domains of Attraction Fractal.* 

"Regular fractals* 3uch as the Snowflalce Curve or the Dragon Curve, are 
generated by following a set of rules. 

A typical set of rules may be: 

Draw a iagged line with 3 straight Una segments. Now replace each of 
those 3 line segments with a smaller copy of the original jagged line and 
so on, replacing each straight Una segment with a smaller copy of the 
jagged segment. 

A rendering of a tree can be made by drawing two branches coming from a 
trunlc. Now replace eac^ branch with a smaller branch which sprouts two 
smaller branches. Repeat this process, again and again, until a tree la 
formed. 



The fractal pictures from FRACTAL EXPLORER are the "Domains of 
Attraction* type of fractals. FRACTAL EXPLORER will create fractal 
geometric shapes using Complex Polynomial Iterative Functions to 
generate and explore the Handelbrot Set and the Julia Set (see 
Acknowledgments for further reading). 
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HOW FRJUnrAL EXPLORER WORKS 



The program begins by displaying an Image of the entire Handelbot Set and 
using this image as the * Parent* or base picture for looming and creating 
additional Images which can be further 'blown up". 

This first Image Is created by Implementing the expression 

2 

2 » Z * C 
n+1 n 

where Z and C are complex numbers (see Appendix A for a brief discussion 
of complex numbers). Each number has two components, a real and en 
imaginary part. By thinking of each number's real part as being on the X- 
axis and the imaginary part as being on the Y-axis, and using the operator 
i to keep the two components separate, the expression can be written as: 

2 

(Zx 4 IZy) <■ (Zx ilZy) * (Cx *lCyi 
HultlpUed out gives; 

2 2 
(Zx * IZy) <- Zx + 12iiZxiiZy * (IZy) t (Cx i ICy) 

where, as In computer code notation, the new value of Z replaces the old 
value. If the real <X part) and the Imaginary (Y part) are grouped, 
( note: 1 times 1 ■ -t ) 

2 2 

Zx * IZy c (Zx - Zy * Cui * 1(2« Zx « Zy + Cy) 
So now each new real and imaginary part replaces Zx and Zy respectively. 
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ow does this btcomB a colorful picture on the Apple II screen ? 

he process Is begun by starting with 2« and 2y equal to lero and an 
rbltrary value Is picked for Cx and Cy. 

Is calculated as described and then the absolute magnitude of Z Is 
slculated to see If It Is growing large. 

lagnltude of Z Is calculated by squaring Z* and squaring Zy and adding 
hem. then take the square root, the same as a vector magnitude. 

-he resultant I Is then calculated Iteratlvely letting the new value 
eplace the old. The Z value will tend to either converge to lero. or grow 

ft ivitnf. pr.mt'.vf. v*1ii*. 

>f tain values of Cx and Cy will cause the Z value to converge to «ro, 
ertaln values of Cx and Cy will cause the Z value to grow to some positive 
-alue, and some values will make Z grow very quickly. It Is how fast that 
his Z value grows which Is given a color representation for the fractal 
mage. It the expression can be Iterated many, many "™" '"^ 
esultant Z value approaches 0. then black Is plotted < the point is "within 
the set"). 

If The Z value starts growing, It will generally become very large «"«''• 
Eew more iterations. An arbitrary value of 2 Is picked as the magnitude 
^ere Z is "blowing up". If the abolute value of Z goes beyond 2 then on 
the next few Iteration It will become very, very large and go sky High . 
The number of iterations called COUNT are then translated Into a color to 
be plotted at that point. COUNT ranges from up to 255 
so the 16 colors of the present palette are cycled through repeatedly. 

Scanning the values from Cx- -2 to +2 and Cy • -1.2 ».**"*«'*2"iK!!lt 
the values of Interest to us and will render the familiar Mandelbrot 
fractal, which we call the parent or base picture. 
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The program plots each of the HMO points (320 * 200) on the Super Hires 
Screen one at a time. 

For the initial Mandelbrot Set Picture, The program starts off by 
scanning, beginning at top left, for 320 values of Cx between -2 and *2 
while holding Cy at -1.2. this will generate the first row of points across 
the top of the screen. 

The Cy value Is incremented by 1/200 to the next Cy value for the next 
row, and the same Cx values are scanned again. This Is repeated until the 
screen is full. The Cy value Is scanned from *t.2 to -1.2. 

The pictures are a "Top View" and give a feeling of the "activity" of the 
function at the locations plotted. The black area in the center is a quiet 
area where the function converges on zero. As we progress outward from 
zero the function will cross some value where It will "come to life" and 
show activity. As we go further from the center, the function "blows up", 
that is, the magnitude of 1 will go "sky high" heading toward Infinity. 
With the Zoom box, we can explore the regions where the function shows 
the most Interesting activity. 
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« JulU Set Pictures use the same etpresslon. 



2 

2 • 2 + C 

n+1 n 

t Instead o£ always starting with I • and scanning C across all of the 
inta ot interest In Ck and Cy, the Julia set calculation starts with C 
lual to some pre-chosen point on the Mandelbrot Set ( some Cii and Cy 
□sen by the user with the Julia Point), and then scans I across some 
ilues of interest mapping each point to the screen. 

I create a JULIA SET picture, first, the user choses a point from a 
ftNDELBROT SET picture, even « loomed MANDELBROT SET picture, by 
jvlng the Julia point around with the mouse or arrow keys. When a point 
chosen, the values of Ck and Cy at that point on the Mandelbrot set are 
itomatically extracted from the MANDELBROT SET and used for the Julia 
>t calculations for Cx and Cy. 
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COUNT MAX is passed to the assembly language calculation routine and Is 
the maximum number of Iterations that will be made at that point. In 
FRACTAL EXPLORER it is adaptive, that is , it is Increasnd by i6 on every 
picture Zoom. COUNT MAX starts at 32 for PlCl ( the base plcl and U 
Increased by 16 on every Zoom up to the limit of 255. 

MAX Z is arbitrarily set equal to 2. U the Magnitude of Z reaches this 
number before COUNT MAX iterations, then the calculation Is stopped and 
the number COUNT (which Is the number of iterations performed to reach Z 
MAX) is returned from the calculation routine. 

It is this number COUNT which Is translated Into a color numbered I 
tnrough 15 (0 Is black and reserved for points within the set) by 
performing modulo U division of COUNT. 

If Z magnitude does not reach Z MAX, after COUNT MAX Iterations, then 
the calculation is exited. 

The point Is within tiie set and a black "quiet" point Is plotted. 

The number of multiplication places Is also adaptive and Is Increased with 
the Zoom number. It begins with 24 bit signed binary arithmetic. 6 bit 
integer and 16 bit fractional part, and Is Increased by 3 bits < to 
correspond to the timftx H Znom - ?x?x7 h ) iirirtl 61 hirs are reached. 

This Is why pictures that have a higher Zoom number take longer to 
calculate. 

All math calculations and graphics plotting are dons in assembly language 
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HINTS. TIPS RMO OTHER INFO: 



The VolufBe nam* oi the Apple IIGS version of FRACTAL EXPLORER 

Is; 

/FRACOS 
Pictures have the pathname, for ex. 
/FRACGS/FRAC.P1CGS1 



When the user eitjts FRACTAL EXPLORER, the user la In the 
BASIC.SYSTEM with all PRODOS commands available. 

More than one picture can be stored at anr loom number. For example, 
multiple pictures can be stored at Zoom 5. Also, previously generated 
pictures can be deleted. i_ 
The Parent (Base) Picture can also be deleted after the first picture Is 
generated from It. If desired. 

Any picture can be renamed with the ProDos RENAME command so that 
they will be dlwlayed In any desired order with the alldeshow. 

The User can create a "Best of" Slide Show of Pictures from different disks 
using any PRODOS file copy type of utility. Be sure to arrange them 
FRAC.P1CCS1 thru FRACPlCGSiS 

If the parent picture FRACJnCGSl Is deleted. It can be senf ated again 
by going Into the create menu and chosing DRAW INITIAL PICTURE. 

Of course, another working disk can be made from the Master Disk. 
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Apple lies generated Pictures are *C1 flletypes which are compatible with 
Palntwtw-kstTH) and other Apple IICS paint programs. Using ona of these 
programs is the suggested way to print out the pictures. 

For Paint Programs, An example of a Super Hires Picture's pathname is; 

/fracgs/frm:.picgsi 

(NOTE: after pictures have been altered with paint programs, the 
constants stored In palette locations may also have been altered. These 
pictures then can be used in FRACTAL EXPLORER SLIDESHOW, but can no 
longer be zoomed from, since the constants have been altered. Therefore, 
only do this to copies of your FRACTAL EXPLORER pictures J 

The FRACTAL EXPLORER pictures are compatible with any APPLE GS slide 
show which will show $C1 type files. 

DO NOT DISTRIBUTE THE FRACTAL EXPLORER SUDESHOW WITH THE 
FRACTAL EXPLORER PICTURES. IT IS A VIOLATION OF COPYRIGHT LAWS 
TO DO SO. 

The flexible, programmable sUdeahow Included with FRACTAL EXPLORER 
Is a significant part of the FRACTAL EXPLORER program. If a user wants 
to use this slideshow, then purchase of FRACTAL EXPLORER is required. 



Since the loom box Is 1/6 of the screen Height and 1/6 of the screen Width, 
tach Zoom Hagnlfles the area In the boit 64 times ( 6 « 6 >. After ten Zooms 
the final screen Is 1/ 6A to the 10 th power, or 1/64 times 1/64 ten times, 
T blown up approKlmately 1,000,000,000.000.000,000 times, area wise. Or 
1.000,000,000 times In width and 1,000.000,000 In height. 



Fhls means that if the first picture were a map of the world, and you 
seated 1 1 pictures (Zooming 11 times), the final picture would be an actual 
ilie picture of the earth's su-face. 



Even though the precision from using 64 bit numbers Is as good as or 
better than used In most computers, due to the finite precision of the 
numbers, xooralng beyond 16 times may yield an inexpeeted picture. 
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APPENDIX A 



COMPLEX NUMBERS 



A complex number will have the form 

Z = X + iY 

where X and Y are real numbers and 1 is the so-called imaginary unit which 
has the definition 

2 

1 = -1 

The real number X is the real component of Z. The iY part la called the 
imaginary component of Z. The actual number Y is a real quantity. 

Addition, subtraction and multiplication of complex numbers follow the 
familiar rules for real quantities. Real quantities are only added to or 
subtracted from other real quantites and imaginary quantites are only 
added to and subtracted from other imaginary quantities. 

For multiplication, as mentioned, 1 times i = -( ,So 

2 2 " 2 2 

< X + lY) = X + 12XY + iY 



2 2 2 
CX + IY) = X - Y + i2XY 

A complex number can be represented geometrically by plotting the real 
component on the X axis and the imaginary part on the Y axis. 
Another property of a complex number is it's length, or absolute 
magnitude I Zl, which can be found by 

2 2 
IZI •= { X + Y ) 

which Is the same as calculating a vector magnitude. 

There are other properties and operations of complex numbers that need 
not be covered here, but can be found in many Algebra books. 
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For further reading on the subject of The Mandelbrot set, the Julia Set, 
and other fractals that may interest the reader, the following book, which 
inspired the program FRACTAL EXPLORER, is suggested: 



The Fractal Geometry of Nature 
by Benoit Mandelbrot 
W.H. Freeman and Co. 



also suggested reading 



The Beauty of Fractals 
by Heini-Otto Pietgen 
Springer- Verlag 



CHAOS Making a New Science 
by James Glelck 
Viking Press 
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